home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / cmdity / clicker.lha / Clicker / README < prev    next >
Text File  |  1996-05-18  |  6KB  |  148 lines
  1. Clicker 1.2:  A key-click commodity
  2.  
  3. REQUIREMENTS
  4.  
  5.   An Amiga running at least release 2.0 of the OS (KickStart V36 or better),
  6.   a keyboard, and a loudspeaker to hear the sounds through.
  7.  
  8.  
  9. COPYRIGHT
  10.  
  11.   This program is in the Public Domain.  Use it as you like, distribute it as
  12.   you like, and modify it as you like.
  13.  
  14.   I'm serious.  Take a look at the sources, they're quite clean and readable if
  15.   you are familiar with C.  It's pure ANSI C and compiles without any warnings
  16.   on at least three well-known compilers.
  17.  
  18.  
  19. INTRODUCTION
  20.  
  21.   This program makes a clicking noise each time you press a key.
  22.  
  23.   Call me crazy (I mean really, go ahead, everybody's doing it) but I hate to
  24.   use keyboards that don't click.  Why?  Well first of all I find no
  25.   encouragement in a machine which just doesn't seem to care.  The Amiga is a
  26.   caring and personal system and it should give you some kind of happy feedback
  27.   --just to show you that it's listening.
  28.  
  29.   Second I like to type without having to look intently at the screen all the
  30.   time.  Whether it's because somebody is talking to me and I have to pretend
  31.   to listen patiently while I'm really still programming, or just because the
  32.   A4000 keyboard doesn't have a reassuring clonk to it so you have to press the
  33.   keys all the way down to make sure that it got the message.  Clicker lets one
  34.   type lighter and faster because one gets to know exactly how much pressure
  35.   the keys require.
  36.  
  37.   Oh and third of course, it annoys the hell out of everybody in a five-meter
  38.   radius so they have something to talk about and can stop worrying about their
  39.   own problems for a minute  (it's an odd thing really that so few people at
  40.   university appreciate what I'm doing for them).  Try it!
  41.  
  42.  
  43. INSTALLATION
  44.  
  45.   This is the simple part.  Just drag the program icon anywhere you like.  If
  46.   you want Clicker to be started automatically when you boot your computer, drag
  47.   it into the WBStartup drawer on your system disk.
  48.  
  49.   If you have a 68020 processor or better, you may want to use the program
  50.   version best optimized for your processor and rename it to Clicker instead.
  51.  
  52.   Clicker.020 is for 68020 systems (plain A1200 or better), Clicker.020fpu is
  53.   for 68020 or 68030 systems with mathematical coprocessors, and Clicker.040fpu
  54.   is for systems based on a 68040 or 68060 with built-in math processor, eg.
  55.   standard A4000/040 or A4000T.  These versions should be slightly more
  56.   efficient if suitable for your machine, giving up to 0.001% performance boosts
  57.   to your system compared to the plain 68000 Clicker binary in some rare cases.
  58.  
  59.   The specialized versions are also slightly shorter, particularly the ones
  60.   compiled for FPU.
  61.  
  62.  
  63. USAGE
  64.  
  65.   Double-clicking the Clicker icon or typing its name from the shell will start
  66.   the program.  Once Clicker is running, double-clicking the icon or typing the
  67.   name again will bring up the program's preferences window.  This is still very
  68.   primitive (no loading or saving yet), but at least it lets you alter volume,
  69.   pitch and duration of the clicks.
  70.  
  71.   The window can also be brought up by selecting Clicker's entry from the
  72.   program list in the Commodities Exchange window and clicking on the Show
  73.   Interface button.  You can also disactivate and reactivate Clicker from there,
  74.   or quit the program altogether.
  75.  
  76.   Here's an overview of the controls in the preferences window:
  77.  
  78.    * Click Mouse Button: If you want Clicker to make its key-click noise for
  79.      mouse-button presses as well as when keys are pressed, select the "Click
  80.      Mouse button" gadget.
  81.  
  82.    * Pitch:  You can pick any tone from the musical scale for the key-click
  83.      noise.  The frequency in Hertz is shown next to the Pitch slider;
  84.      Drag the slider to the left to get a lower tone, or to the right to get a
  85.      higher one.  Unfortunately there's only a very short range of useful
  86.      pitches at the moment.
  87.  
  88.   (For the musically literate user:  In a vain and deluded attempt to not offend
  89.   anybody's ears the tone of the clicks can be selected over a 9-octave range of
  90.   the equal-temperament tuning based on the 440-Hertz A)
  91.  
  92.    * Length:  This determines how long the noise of every click should last.
  93.      Because the duration of a key click is typically very short, the Length
  94.      setting does not regulate the number of microseconds the sound is played
  95.      but the number of times the entire wave-form sample is played altogether.
  96.      This means that with the same Length setting you will get longer duration
  97.      for low pitches than with higher pitches.
  98.  
  99.  
  100. OPTIONS
  101.  
  102.   Shell command-line template:
  103.         PITCH/N VOLUME/N LENGTH/N CLICKMOUSE/S CX_POPUP/S
  104.  
  105.   Icon tooltypes:
  106.         PITCH=<frequency in Hertz>
  107.         VOLUME=<loudness between 1 and 64>
  108.         LENGTH=<length of click>
  109.         CLICKMOUSE=<YES or NO>
  110.  
  111.         CX_POPUP=<YES or NO>
  112.         DONOTWAIT
  113.  
  114.   See USAGE for an explanation of the program settings.
  115.  
  116.   The CX_POPUP tooltype tells Clicker to show its preferences window on startup.
  117.  
  118.   If you want to put Clicker in your WBStartup, the DONOTWAIT tooltype tells the
  119.   Workbench not to wait for the program to finish before continuing its startup
  120.   procedure.  Clicker will only return after you close it by sending it a CTRL-C
  121.   signal ("break") or by sending it a "Remove" message from the Commodities
  122.   Exchange window.
  123.  
  124.  
  125. AUTHOR
  126.  
  127.   Jeroen T. Vermeulen, currently still a Computer Science student at the
  128.   university of Leiden, The Netherlands but soon to be unleashed upon an
  129.   unprepared outside world.  It will be hard for life to adjust itself to me
  130.   again, but I'll be damned if I'm going to work with Windows.  Got a position
  131.   open by any chance?
  132.  
  133.   Mail: jvermeul@wi.leidenuniv.nl / jtv@xs4all.nl
  134.   Phone/Fax: +31.20.6258990
  135.  
  136.  
  137. REVISION HISTORY
  138.  
  139.   (lots of 0.x versions that you don't want to know about unless you're one of
  140.   my beta testers, but they inexplicably insisted on remaining anonymous)
  141.  
  142.   1.0 - First public release
  143.   1.1 - Now compiles with SAS/C, gcc and StormC.  Makefiles included.
  144.   1.2 - Program tried to open "utitility.library" and failed of course.  Ouch.
  145.         New:  When channel is stolen, new one is allocated for next click.
  146.         Don't compile with gcc for now!  (doesn't support vars in CHIP mem yet)
  147.   1.3 - Cleaned up source a little and gained some speed.
  148.